.TH E1432_SET_TTLTRG_GCLOCK 3 E1432
.SH NAME
.nf
e1432_set_ttltrg_gclock \- Select a TTLTRG line for gated clock
e1432_get_ttltrg_gclock \- Get current TTLTRG line for gated clock
.fi
.IX e1432_set_ttltrg_gclock(3) 3
.IX e1432_get_ttltrg_gclock(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_ttltrg_gclock(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 ttltrg)
SHORTSIZ16 e1432_get_ttltrg_gclock(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 *ttltrg)
.cE
.SH DESCRIPTION

Gated clock lines are not normally used by the E1432 module, so this
function is not normally used.

\fIe1432_set_ttltrg_gclock\fR sets the VXI TTLTRG line used for the
gated clock.  If a measurement is in progress while calling this
function, the measurement is aborted.  The gated clock is normally
turned on only when data is actively being collected for a block of
data that will be sent to the host.  Other VXI devices could use this
clock and know that they are sampling data at the same time as the
E1432.

\fIe1432_get_ttltrg_gclock\fR returns the currently selected VXI
TTLTRG line for the gated clock in the memory location pointed to by
\fIttltrg\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIttltrg\fR selects a VXI ttltrg line to be used for the
gated sample clock.

\fBE1432_TTLTRG_0\fR selects TTLTRG0 for the clock.
\fBE1432_TTLTRG_1\fR selects TTLTRG1 for the clock.
\fBE1432_TTLTRG_2\fR selects TTLTRG2 for the clock.
\fBE1432_TTLTRG_3\fR selects TTLTRG3 for the clock.
\fBE1432_TTLTRG_4\fR selects TTLTRG4 for the clock.
\fBE1432_TTLTRG_5\fR selects TTLTRG5 for the clock.
\fBE1432_TTLTRG_6\fR selects TTLTRG6 for the clock.
\fBE1432_TTLTRG_7\fR selects TTLTRG7 for the clock.

The mere selection of the TTLTRG line by this function does not
necessarily cause the clock to get driven onto that TTLTRG line.  The
TTLTRG line is driven only if one of the following conditions is met:

1. \fIe1432_set_multi_sync\fR is \fBE1432_SYSTEM_SYNC_VXD\fR or
   \fBE1432_SYSTEM_SYNC_VXD_MIN\fR.

2. \fIe1432_set_clock_source\fR is \fBE1432_CLOCK_SOURCE_VXI\fR
   or \fBE1432_CLOCK_VXI_DEC_3\fR.
.SH "RESET VALUE"
After a reset, \fIttltrg\fR is set to \fBE1432_TTLTRG_1\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_ttltrg_clock, e1432_set_ttltrg_satrg,
e1432_set_ttltrg_trigger, e1432_set_ttltrg_lines
.ad
